home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / robot140.zip / ROBOT.DOC < prev    next >
Text File  |  1991-01-20  |  18KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                         Robot
  30.  
  31.  
  32.                            A Murder Motel Utility Program
  33.  
  34.  
  35.                                     Version 1.40
  36.  
  37.  
  38.                       Copyright 1989, 1990, 1991 by Duane Brown
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   Table of Contents
  71.  
  72.  
  73.      Uses for Robot  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  74.  
  75.      Setting up Robot  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  76.  
  77.      Configuration File Structure  . . . . . . . . . . . . . . . . . . .    2
  78.  
  79.      A Note to Users of Robot 1.0/1.1  . . . . . . . . . . . . . . . . .    3
  80.  
  81.      Revision History  . . . . . . . . . . . . . . . . . . . . . . . . .    3
  82.  
  83.      Future Enhancements to Robot  . . . . . . . . . . . . . . . . . . .    4
  84.  
  85.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . .    4
  86.  
  87.      Registration and Other Legal Stuff  . . . . . . . . . . . . . . . .    6
  88.  
  89.      For Emergency Use Only  . . . . . . . . . . . . . . . . . . . . . .    6
  90.  
  91.      Registration Form . . . . . . . . . . . . . . . . . . . . . . . . .    7
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                              Murder Motel Robot Utility
  137.                                Written by Duane Brown
  138.                                     Version 1.40
  139.                       Copyright 1989, 1990, 1991 by Duane Brown
  140.  
  141.           This program is designed for the sysop that wishes to provide users
  142.        of the Murder Motel version 2.0/2.2 door, written by Sheldon Pasciak,
  143.        with more than the average Murder Motel game.  This program controls
  144.        automated Murder Motel players (robots) that run around and act like
  145.        other players.  These robots will, depending on how the sysop
  146.        configures the program, do the following:
  147.  
  148.        a) Select a complete weapon and two different defenses, if they are
  149.           available,
  150.  
  151.        b) Select a target for killing,
  152.  
  153.        c) Move along the map and attempt a kill if the robot has a target,
  154.           and
  155.  
  156.        d) Log all of these activities to disk file for sysop use.
  157.  
  158.           This program is designed to be run as part of the daily maintenance
  159.        routine.  However, it can be run immediately after the Murder Motel
  160.        door if so desired. 
  161.  
  162.  
  163.        Uses for Robot
  164.        ==============
  165.  
  166.           Robot is great for keeping an active list of available targets for
  167.        your users if they are quite active in their killing sprees.  It also
  168.        can be used to "fill in" for some players who may be too busy to play
  169.        the game for a few days, yet want to stay alive (like busy sysops). 
  170.        If the program is configured correctly, users may not be able to tell
  171.        which players are robots and which ones are BBS users!
  172.  
  173.  
  174.        Setting up Robot
  175.        ================
  176.  
  177.           NOTE:  The program as distributed requires that a copy of
  178.        Brun45.exe be in the current directory or in the DOS path.  If
  179.        requested, I will provide you with a version that does not require the
  180.        Brun45.exe file.  However, since many doors use the Brunxx.exe files
  181.        (xx = 20, 30, 40, 45, etc), most likely you have Brun45.exe already. 
  182.        If you do not have this file, let me know and I will make the
  183.        Brun45.exe file available for download.
  184.  
  185.           Place a copy of robot.exe in your Murder Motel directory, along
  186.        with a copy of robot.cfg.  The syntax for Robot is:
  187.  
  188.        Robot filename.ext
  189.  
  190.        where filename.ext is the name of the configuration file.  I have
  191.        enclosed a sample configuration file called Robot.cfg which you can
  192.        use immediately. 
  193.  
  194.  
  195.  
  196.  
  197.        Robot                              1            A Murder Motel Utility
  198.  
  199.  
  200.  
  201.  
  202.           IMPORTANT NOTE:  Unregistered versions will ask you to enter a 4
  203.        digit random number before starting up.  Registration will remove this
  204.        prompt and allow you to run Robot unattended.
  205.  
  206.  
  207.        Configuration File Structure
  208.        ============================
  209.  
  210.        The structure of the configuration file is as follows:
  211.  
  212.        LogFileName
  213.        RevivalPercent
  214.        MovementPercent
  215.        GetNewObjectPercent
  216.        PickTargetPercent
  217.        NumberofRobotMoves
  218.        <list of up to 10 robot player names>
  219.  
  220.        <any comments you may want to put in>
  221.  
  222.        LogFileName is the name of the file where Robot stores comments about
  223.        what happens while it is running.  If this line is left blank, no
  224.        logging to disk will occur.
  225.  
  226.        RevivalPercent is an integer number from 0 to 100 that represents the
  227.        chance that a robot player will be brought back to life if found dead. 
  228.        A value of 0 means that the robot will never be revived, while 100
  229.        means that a robot player will always be revived.  
  230.  
  231.        MovementPercent is an integer number from 0 to 100 that represents the
  232.        chance that the robot will move around the map.  A value of 0 means
  233.        there is no chance of movement, while 100 guarantees that movement
  234.        will occur.  
  235.  
  236.        GetNewObjectPercent is an integer number from 0 to 100 that represents
  237.        the chance that a robot will drop all objects and pick out a new
  238.        weapon and defenses.  0 means no changing of weapons, while 100 means
  239.        a new set of objects will always be chosen.  
  240.  
  241.        PickTargetPercent is an integer number from 0 to 100 that represents
  242.        the chance that a robot will select a target for killing.  Setting
  243.        this number to 0 means that the robot player won't ever choose a
  244.        target (making the robots just dumb targets), while setting this to
  245.        100 means that the robots will become crazed, murdering maniacs that
  246.        can't stop killing people <grin>.  
  247.  
  248.        NumberofRobotMoves is the number of moves that the robots will use if
  249.        they  are able to move around.  Note that movement occurs according to
  250.        the Murder Motel map, using the directions available to normal
  251.        players, not by just choosing random locations and going to them. 
  252.        Thus, the robots will get 'lost' and spend more time wandering around
  253.        if you have a 'maze-type' setup.
  254.  
  255.        The rest of the file, upto a blank line, consists of the names of the
  256.        robot players.  Keep these names limited to one or two words, as that
  257.        is all that Murder Motel can handle.  Names are automatically
  258.        converterted to upper case.  The maximum number of robots that will be
  259.        read from the list is 10.
  260.  
  261.  
  262.  
  263.        Robot                              2            A Murder Motel Utility
  264.  
  265.  
  266.  
  267.  
  268.        You can place any additional comments after the last robot name. 
  269.        However, you must leave at least one blank line between the last robot
  270.        name and the beginning of the comments.  Note that I put in a brief
  271.        description of what all the lines mean (so you don't have to go back
  272.        and search for the documentation file if you don't know what a number
  273.        means).
  274.  
  275.  
  276.        A Note to Users of Robot 1.0/1.1
  277.        ================================
  278.  
  279.           Upgrading from Robot 1.0 or 1.1 is easy.  Overwrite the old
  280.        Robot.exe with the new Robot.exe, then using your robot.lst file as a
  281.        guide, add your Robot names to robot.cfg.  Don't forget to add your
  282.        change your batch files to reflect the new configuration filename.
  283.  
  284.  
  285.        Murder Motel Files Read/Written
  286.        ===============================
  287.  
  288.        The program will read in the following files from the Murder Motel
  289.        directory:
  290.  
  291.        Murder.Cfg, People.Mmi, Objects.Mmi, Murder.Map, Squeals.Mmi,
  292.        Empty.Mmi
  293.  
  294.        In addition, the program renames the original files to .bak files and
  295.        writes new data to these files:
  296.  
  297.        People.Mmi, Objects.Mmi, Squeals.Mmi, Motion.Mmi
  298.  
  299.        If a kill is attempted by any of the robots, Killed.Mmi is updated.
  300.  
  301.  
  302.        Revision History
  303.        ================
  304.  
  305.        December 26, 1989
  306.        Version 1.00
  307.  
  308.        Initial release.
  309.  
  310.        January 12, 1990
  311.        Version 1.10
  312.  
  313.        Converted to QuickBasic 4.5 (now requiring Brun45.exe), fixing several
  314.        bugs.  Now the robots choose two defenses only and a one complete
  315.        weapon, if the parts are available.
  316.  
  317.        November 26, 1990
  318.        Version 1.30 beta
  319.  
  320.        Major upgrade.  Lost the source code for version 1.1, so had to start
  321.        off with the source for 1.0.  Added the following features:
  322.  
  323.        Robots actually do move!  Robots can pick targets, and attempt a kill,
  324.        following all of the usual Murder Motel rules for processing a kill.
  325.        Actions performed by the program can be logged to a disk file if
  326.        desired.  Registration key system added to encourage registrations. 
  327.        Logging of kills, attempts, etc. to Killed.Mmi.   
  328.  
  329.        Robot                              3            A Murder Motel Utility
  330.  
  331.  
  332.  
  333.  
  334.  
  335.        (many beta versions later)...
  336.  
  337.        January 21, 1991
  338.        Version 1.40 
  339.  
  340.        Many thanks to my beta bashing team for finding the bugs that skipped
  341.        even my scrutiny (and there were some doozies in there!). 
  342.  
  343.  
  344.        Future Enhancements to Robot
  345.        ============================
  346.  
  347.        Robot has grown a great deal since it's birth and first release on
  348.        Christmas Day, 1989.  I have included several ideas from my beta
  349.        testers in this version of Robot, and plan to add a lot more in the
  350.        upcoming months.  Here is summary of the some of the changes that will
  351.        be added to Robot in the near future:
  352.  
  353.        Individual percentage values for each robot, instead of forcing all
  354.        robots to have the same values (ie give each of the robots a different
  355.        'personality') [Ric Smith]
  356.  
  357.        Specify days of the week to run the robots (A for all, O for odd, E
  358.        for Even, etc) [Stephen King]
  359.  
  360.        Multiple Kills per robot (instead of the current method of not
  361.        selecting an additional victim after killing, or attempting to kill,
  362.        one person) [Stephen King]
  363.  
  364.        An Assassinate Mode:  Tell the robot to go and kill a user, picking
  365.        the right weapons/defenses, on sysop command. [Stephen King]
  366.  
  367.        Allow a list of players not to be chosen by the robots [Ric Smith]
  368.  
  369.        The reason why these changes are not included (yet) is that they will
  370.        cause a change to the configuration file structure.  I want a good,
  371.        workable program out of the 'door', so to speak, for others to use
  372.        before I start working on an even more enhanced version of Robot.
  373.  
  374.         
  375.        Acknowledgements
  376.        ================
  377.  
  378.        Sheldon Pasciak, for creating one of the best door games around
  379.        (Murder Motel).
  380.  
  381.        Many thanks go to my beta testing team:
  382.  
  383.        Kevin & Gary Graham, Fredericksburg, VA
  384.        Cracker Barrel, Fidonet 1:274/24
  385.        703-899-0020
  386.  
  387.        Mark & Diana Taylor, Fort Wayne, IN
  388.        Fire Station, Fidonet 1:236/10
  389.        219-447-3011
  390.  
  391.  
  392.  
  393.  
  394.  
  395.        Robot                              4            A Murder Motel Utility
  396.  
  397.  
  398.  
  399.  
  400.        Paul King, Rochester, NY
  401.        The Omega Concern, Fidonet 1:260/241
  402.        716-292-0634
  403.  
  404.        Stephen King, Riverside, CA
  405.        Commnet-386
  406.        714-359-3189
  407.  
  408.        Ric Smith, Fredericksburg, VA
  409.        Spider's Web, Fidonet 1:274/19
  410.        703-891-2324
  411.  
  412.        John Schreiber, Falmouth, VA
  413.        Thunderbolt BBS, Fidonet 1:274/13, Echonet 50:5703/13
  414.        703-373-9289
  415.  
  416.        Cindy Edens, Satellite Beach, FL
  417.        Motel Florida, Fidonet 1:3610/6
  418.        407-773-2831
  419.  
  420.        Kelley Smith, Dale City, VA
  421.        Connect! BBS, Fidonet 1:265/102
  422.        703-670-5037
  423.  
  424.        Russell Femyer, Lemon Grove, CA
  425.        I.D.I.C, Fidonet 1:202/310
  426.        619-461-0982
  427.  
  428.        Robert York, Milton, WA
  429.        Doctor Debug's Domain
  430.        1-206-535-1542
  431.  
  432.        Chrys Hird, Apple Valley, MN
  433.        Unlisted Node, Fidonet 1:282/51
  434.        1-612-431-6594
  435.  
  436.        And especially to:
  437.  
  438.        Mark Taylor, whose encouragement caused me to start re-working on
  439.        Robot, and for being my first registered user for any of my programs!
  440.  
  441.        Ric Smith, for finding the BIG BUG in the inaccurate altering of the
  442.        players status when killing/picking (glad you're a local call...we
  443.        spent enough time trying to figure this one out)
  444.  
  445.        Paul King, for reporting the squeals.mmi bug (fixed in 1.31 beta of
  446.        Robot) -- since my Squeal file has all 10 entries full, I never saw
  447.        that Robot 1.30 added the "0,0" entries (aka "A deleted user was found
  448.        at area # 0" squeals message).  
  449.  
  450.        Stephen King, for all of the suggestions mentioned above and helping
  451.        me out with finding the exact wording of the Killed.Mmi entries for
  452.        those 'unusual' circumstances. <grin>
  453.  
  454.        Cindy Edens, for being an all-around helpful tester and forcing me to
  455.        download many, many excellent RA utilities even though my phone bill
  456.        didn't want to <grin>.
  457.  
  458.  
  459.  
  460.  
  461.        Robot                              5            A Murder Motel Utility
  462.  
  463.  
  464.  
  465.  
  466.        Registration and Other Legal Stuff
  467.        ==================================
  468.  
  469.           If you find after a reasonable amount of time (around 30 days) that
  470.        Robot meets your needs, you must register the program.  After
  471.        receiving your registration key, you will be able to run Robot in
  472.        unattended (batch) mode.  I will also add your name to my mailing
  473.        list, give you advance notice for updates on this and my other
  474.        programs, and send you updated versions of any of my programs that you
  475.        have.
  476.  
  477.           Permission is granted to post this program on electronic Bulletin
  478.        Board systems.  Therefore, you are encouraged to upload the unaltered,
  479.        unmodified archive file to Bulletin Board Systems, even if you do not
  480.        use this program.  There are no warranties, express or implied, other
  481.        than that this software will take up space on your disk.  I have tried
  482.        to make this program as safe as possible, but I will not be held
  483.        responsible for any losses as the result from the use of this program.
  484.  
  485.           The registration fee is $10, payable by check or money order, to
  486.        Duane Brown at the address below.  Print out and fill in the requested
  487.        information and I will send you the key file, or the information
  488.        needed for you to create the key file, and instructions on how to
  489.        install this file.  I will send the key file to you via Netmail if you
  490.        are on either Fidonet or Echonet, or call your BBS and upload the key
  491.        file.  If you wish for me to call your board and upload the key,
  492.        please set up an account under the name "Duane Brown" that will allow
  493.        uploading, and enter the password on the registration form.  
  494.  
  495.           If you do not want me to send the key file to you electronically, I
  496.        will send you instructions on how to create the key file by mail. 
  497.        However, if you have any additional comments, bug reports, etc, please
  498.        feel free to get in touch with me via Snail-mail at
  499.  
  500.        Duane Brown
  501.        100 Pewter Lane
  502.        Stafford, VA 22554-1518
  503.  
  504.        or call
  505.  
  506.        The End of the Line BBS
  507.        Stafford, Virginia
  508.        Data (703)720-1624, 24 hours a day.
  509.        Running Dbridge 1.30/1.31 with Remote Access 0.04a (registered)
  510.        accepting 300/1200/2400 MNP 4 callers.
  511.        Fidonet 1:274/16, Echonet 50:5703/16
  512.        Crash mail accepted.  Full access to first time callers.
  513.  
  514.        For Emergency Use Only
  515.        ======================
  516.  
  517.        If you have a question that absolutely can not wait, you can call me
  518.        voice at (703)659-6302 at reasonable hours (i.e. before 9:30 pm
  519.        Eastern Time).  If I am available, I will do my best to help you out. 
  520.        However, I can diagnose problems better if I have a copy of your
  521.        Murder Motel files so I can look at them.
  522.  
  523.  
  524.  
  525.  
  526.  
  527.        Robot                              6            A Murder Motel Utility
  528.  
  529.  
  530.  
  531.  
  532.        Registration Form
  533.        =================
  534.  
  535.        Please fill out the following information, along with your check or
  536.        money order, and mail to:
  537.  
  538.        Duane Brown
  539.        100 Pewter Lane
  540.        Stafford, Virginia 22554-1518.
  541.  
  542.        Your registration will be processed within one day of receipt.  Thank
  543.        you for supporting shareware.
  544.  
  545.  
  546.        Program Registering:   ___Robot____
  547.  
  548.        Version Number:        ____________
  549.  
  550.        Sysop Name: __________________________________________________________
  551.                     (case is significant!)
  552.  
  553.        BBS Name:  ___________________________________________________________
  554.                     (case is significant!)    
  555.  
  556.        Hours of Operation:  _________________________________________________
  557.  
  558.  
  559.        Send the Registration Key: Via Netmail? [ ] Uploading to Your BBS? [ ]
  560.                                   Snailmail (US Postal Service?) [ ] 
  561.  
  562.        Password:  ___________________________________________________________
  563.         (only needed if requesting 'Uploading to Your BBS?' box above)
  564.  
  565.        Where did you get this program?  _____________________________________
  566.  
  567.  
  568.        Fidonet/Othernet Address(es):   ______________________________________
  569.  
  570.  
  571.        Any additional Comments/Suggestions (Use other sheets if necessary):
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.        Robot                              7            A Murder Motel Utility
  594.  
  595.